home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / graphics / containr / readme.txt < prev   
Text File  |  1994-12-24  |  3KB  |  71 lines
  1. CONTAINER VBX - A VBX FOR STORING AND RETRIEVING BITMAPS IN VB PROGRAMS
  2.  
  3. This VBX is an attempt to make it easier for VB programmer to use bitmaps
  4. in their programs without having to deliver all these files separately
  5. with your program or use a dummy form with a lot of image controls on it
  6. (that's a real memory consumer and loading such a form is terribly slow).
  7.  
  8. The container VBX is nothing more than the name says: it's a container
  9. of pictures. Using the VBX involves the following steps:
  10.  
  11. 1.   Start the RC-EDIT program. This program allows you to specify the
  12.      bitmaps (.BMP or .DIB) that you'd like to be compiled into the VBX
  13.      With RC-EDIT you can roam your harddisk(s) and select all the
  14.      bitmaps you'd like to use in your program. After you've specified
  15.      the bitmaps you want to use, type a name for the VBX (8 characters
  16.      at most, 'LIBRARY' for example) and press the 'Start'-button. the
  17.      RC-EDIT program will now perform the following steps:
  18.      -   The CONTAINR.VBX will be copied to the name you've specified
  19.          (LIBRARY.VBX for example)
  20.      -   The CtlName of the VBX will be patched in the VBX and will
  21.          become the name of the VBX with 'Pics' appended to it
  22.          (LibraryPics for example)
  23.      -   All the bitmaps and dibs you've choosen will be compiled into
  24.          the VBX.
  25.  
  26. 2.   When the RC-EDIT program is done, you should have a new VBX that
  27.      has all the bitmaps in it. You can add this VBX to your Visual Basic
  28.      project and add an instance of it to a form in your project.
  29.  
  30. 3.   Now it's time to retrieve the images from the VBX. You can do this
  31.      by setting the VBX'es ResourceNumber property to anything but zero.
  32.      This causes the VBX to read the picture with that number to be loaded
  33.      and set to the Picture property of the VBX. Now you can use the Picture
  34.      property to copy the picture to another control:
  35.  
  36.          LibraryPics.ResourceNumber = 1
  37.          Picture1.Picture = LibraryPics.Picture
  38.  
  39.      After that you free the picture (to avoid it taking up valuable memory),
  40.      by setting to Picture property to (none):
  41.  
  42.         LibraryPics.Picture = LoadPicture()
  43.  
  44.      The RC-EDIT program also creates a Visual Basic BAS-file that includes
  45.      named constants for all the pictures inside the VBX.
  46.  
  47. 4.   That's all there is to it.
  48.  
  49. A few remarks:
  50.  
  51. -  You can use as many Container VBX'es in your application as you like.
  52.    Since the name of the control is changed by RC-EDIT for each new control
  53.    you create with it, there is no conflict in windows library-names and
  54.    visual-basic control-names.
  55. -  The Container VBX and the RC-EDIT, RC and RCPP programs must be in the
  56.    same directory. RC-EDIT does no error checking whatsoever, so make sure
  57.    they're all there.
  58. -  The container VBX is free. You may use it in any program you like, but:
  59.    - you use the VBX on your own risk. In no case shall SheAr software be
  60.      liable for any damages that may result from using this VBX. If you use
  61.      this VBX you agree to be bound by this notice.
  62.    - if you like to give away copies of the VBX to friends, give them the
  63.      full archive, including this notice.
  64.  
  65.  
  66. If you have any questions about this VBX or if there's anything else you'd
  67. like to know, don't hesitate to contact me through e-mail:
  68.  
  69. vbx_dev@shear.iaf.nl
  70.  
  71. Arjen Broeze